Sending a Command to a Device

Device commands are special instructions that can be sent from Map Suite GPS Tracking Server to a GPS tracking device in the field. If a GPS tracking device supports a command, it can carry out a specified action when it receives one, such as unlocking a vehicle's doors, taking a photo or video, or simply sending updated location coordinates back to Map Suite GPS Tracking Server. Device commands are a great way for users to "remote control" devices in the field, beyond mere geolocation.

Prerequisites

Before you can send commands to a particular tracking device, the following must be true:

• The device hardware itself must support the receipt of commands.
• The Device Listener for this hardware type must be programmed to handle the appropriate commands and transmit them in a manner that the device can understand.
• At least one command must be defined in the Device Command Summary area of the Administration Portal.
• The device must be configured in Map Suite GPS Tracking Server with the "Supports Two Way Messaging" box checked. This can be done either:
  • When the new device is initially set up - see topic Adding a New Device
  • When the existing device's configuration is edited - see topic Device Editor: Name and Profile

To begin sending a command to a device

1. Go to the Tracking Screen.
2. On the Sessions entity tab within the left side panel, find the device you want to send a command to.
3. Click on the icon next to that device.

Or

1. Go to the Device Summary List.
2. Click the icon next to the device you want to send a command to.
3. Click the Messages tab on the left side of the Device Editor dialog.

Whichever method you choose above, you will be presented with the Send Device Command dialog.

Sending the Device Command 

Send Device Command dialog

From the Send Device Command dialog, you can send a command directly to the tracking device. Here's how:

1. Select the command you want to send from the Commands drop-down box.
2. Depending upon the command you selected, one or more optional parameters may appear beneath the Commands drop-down box. Fill out these parameters to provide further information about the command you are sending.  For example, if you are issuing a command to change the IP and port that the device is using to communicate with Map Suite GPS Tracking Server, you will need to enter the new IP address and new port number that you want the device to use.
3. Click the Send button to submit the command to the device.

At any time, the button can be clicked to close the Send Device Command dialog.

More:

Viewing Commands Previously Sent to a Device